home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / f90 / flush.z / flush
Encoding:
Text File  |  1998-10-30  |  3.3 KB  |  72 lines
  1. FLUSH(3F)                                              Last changed: 1-6-98
  2.  
  3.  
  4. NNAAMMEE
  5.      FFLLUUSSHH - Writes data buffered by Fortran output statements to a file
  6.  
  7. SSYYNNOOPPSSIISS
  8.      UNICOS and UNICOS/mk systems:
  9.      CCAALLLL FFLLUUSSHH((_i_u_n_i_t))
  10.  
  11.      CCAALLLL FFLLUUSSHH((_i_u_n_i_t,,[[_i_s_t_a_t]]
  12.  
  13.      IRIX systems:
  14.      CCAALLLL FFLLUUSSHH((_i_u_n_i_t,, _i_s_t_a_t))
  15.  
  16. IIMMPPLLEEMMEENNTTAATTIIOONN
  17.      UNICOS, UNICOS/mk, and IRIX systems
  18.  
  19. DDEESSCCRRIIPPTTIIOONN
  20.      FFLLUUSSHH writes to a file any buffered data previously written by Fortran
  21.      output statements.  FFLLUUSSHH may be called after reading or writing.  The
  22.      current file position is not changed.
  23.  
  24.      When using the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
  25.      UNICOS, UNICOS/mk, or IRIX, all arguments must be of default kind
  26.      unless documented otherwise.  On UNICOS and UNICOS/mk, default kind is
  27.      KKIINNDD==88 for integer, real, complex, and logical arguments; on IRIX, the
  28.      default kind is KKIINNDD==44.
  29.  
  30.      This routine has the following arguments:
  31.  
  32.      _i_u_n_i_t     Integer variable, expression, or constant containing a
  33.                Fortran unit number.  If this value is 101, it flushes the
  34.                unit which is connected to standard output.
  35.  
  36.      _i_s_t_a_t     Integer variable or array element that receives the return
  37.                status as follows:
  38.  
  39.                ==00   Indicates that all buffered data, if any, was flushed.
  40.                     A file that was immediately read, or a file with a
  41.                     buffer that has not changed since the last flush, might
  42.                     return a 0 status even though no new data would be
  43.                     written to the file.
  44.  
  45.                --11   Indicates that the Fortran unit does not support FFLLUUSSHH,
  46.                     and no data was written to the file.
  47.  
  48.                >>00   Indicates that an error condition was encountered.  The
  49.                     specific error number is returned.  Use the eexxppllaaiinn(1)
  50.                     command for a description of the error code.
  51.  
  52.      The _i_s_t_a_t argument is optional on UNICOS systems; the user program is
  53.      aborted if FFLLUUSSHH is called without _i_s_t_a_t and an error condition is
  54.      encountered.
  55.  
  56. NNOOTTEESS
  57.      If FFLLUUSSHH is called with an unconnected unit, an error condition
  58.      results.  Calling FFLLUUSSHH for a file for which the program does not have
  59.      write permission returns a 0 status if no data was written to that
  60.      file previously with Fortran I/O statements.
  61.  
  62.      A WWRRIITTEE I/O statement with an asterisk unit identifier (or a PPRRIINNTT
  63.      statement) uses unit 101.  See IINNTTRROO__IIOO(3F) for more information.
  64.  
  65. SSEEEE AALLSSOO
  66.      eexxppllaaiinn(1) in the _U_N_I_C_O_S _U_s_e_r _C_o_m_m_a_n_d_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication
  67.      SR-2011 to see a description of the error code.
  68.  
  69.      _A_p_p_l_i_c_a_t_i_o_n _P_r_o_g_r_a_m_m_e_r'_s _L_i_b_r_a_r_y _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, publication SR-
  70.      2165, for the printed version of this man page.
  71.  
  72.